Developer Documentation

QuickTime 4 API Documentation

QuickTime Streaming

| Previous | Chapter Contents | Chapter Top | Next |

Set Up and Information Functions

If you do not open a stream handler and set its timescale during initialization, you must implement the RTPRssmGetTimeScaleFromPacket function. If you have not set the stream handler's timescale, the base reassembler will call your reassembler's GetTimeScaleFromPacket function with every incoming packet until a stream handler is open and its time scale is set.

If you cannot determine the timescale based on the contents of the packet, return qtsUnknownValueErr , or a zero timescale.

EXTERN_API( ComponentResult )
RTPRssmGetTimeScaleFromPacket(
    RTPReassembler rtpr,
    QTSStreamBuffer *inStreamBuffer,
    TimeScale * outTimeScale);


The RTPRssmGetInfo , RTPRssmSetInfo, and RTPRssmHasCharacteristic functions can be called at any time, even prior to initialization. RTPRssmHasCharacteristic is called to determine what features your reassembler supports. RTPRssmGetInfo is used to get information from your reassembler. RTPRssmSetInfo could be used to send information to your reassembler, but there are currently no selectors that do this.

These functions are commonly used if your reassembler supports passing of non-media data, such as transformation matrices. The functions are typically called after your reassembler reports a change in a non-media parameter by calling RTPRssmSendStreamHandlerChange , as described in "Passing Non-Media Data." The selectors used for passing non-media data are the same for RTPRssmHasCharacteristic and RTPRssmGetInfo . These selectors begin with kQTSSource and are defined in QTStreaming.h.

Delegate any selectors you do not support or do not understand to the base reassembler for all of these functions.

EXTERN_API( ComponentResult )
RTPRssmSetInfo      (RTPReassembler rtpr,
    OSType  inSelector,
    void *  ioParams) ;


EXTERN_API( ComponentResult )
RTPRssmGetInfo  (RTPReassembler rtpr,
     OSType     inSelector,
     void *     ioParams) ;


EXTERN_API( ComponentResult )
RTPRssmHasCharacteristic(RTPReassembler rtpr,
    OSType      inCharacteristic,
    Boolean *   outHasIt) ;



© 1998 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |